package com.example.testplatform.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.testplatform.entity.Role;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * 角色Mapper接口
 */
@Mapper
public interface RoleMapper extends BaseMapper<Role> {
    
    /**
     * 查询所有角色
     * @return 角色列表
     */
    List<Role> findAll();
    
    /**
     * 根据ID查询角色
     * @param id 角色ID
     * @return 角色信息
     */
    Role findById(@Param("id") Long id);
    
    /**
     * 根据条件分页查询角色
     * @param params 查询参数
     * @param offset 偏移量
     * @param limit 每页数量
     * @return 角色列表
     */
    List<Role> findByPage(@Param("params") Map<String, Object> params, 
                         @Param("offset") Integer offset, 
                         @Param("limit") Integer limit);
    
    /**
     * 根据条件查询角色总数
     * @param params 查询参数
     * @return 角色总数
     */
    Integer count(@Param("params") Map<String, Object> params);
    
    /**
     * 检查角色代码是否存在
     * @param roleCode 角色代码
     * @param id 排除的角色ID（用于更新时）
     * @return 存在的数量
     */
    Integer checkRoleCode(@Param("roleCode") String roleCode, @Param("id") Long id);
    
    /**
     * 批量删除角色
     * @param ids 角色ID列表
     * @return 删除的数量
     */
    Integer deleteBatch(@Param("ids") List<Long> ids);
}